home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / WWW / HSC0916.ZIP / !hsc / README < prev   
Text File  |  1998-01-12  |  3KB  |  97 lines

  1.  
  2. TITLE
  3.  
  4.   hsc - html sucks completely
  5.  
  6. VERSION 
  7.  
  8.   0.916
  9.  
  10. AUTHOR
  11.  
  12.   Thomas Aglassinger <agi@giga.or.at>
  13.  
  14. DESCRIPTION
  15.  
  16.   Hsc is a developer tool for html-projects.
  17.  
  18.   It can be used on any html file and creates a new html file as
  19.   output. In the input file, you may use an extended syntax based on
  20.   html, but which also allows extensions like macros, conditionals and
  21.   more.
  22.  
  23.   It's mainly intended to create and maintain larger html projects. As
  24.   a CLI-only tool, it can be used together with `make', and a
  25.   dependency generator is included.
  26.  
  27.   Hsc is *not* a tool to make html easier for beginners; it's a tool
  28.   to make html a bit less painful and brain-damaged for people who
  29.   already know how to work with it.
  30.  
  31. FEATURES
  32.  
  33.   - macros (implemented as additional tags)
  34.   - conditionals (if/else/elseif)
  35.   - expressions, supporting
  36.     - string concatenation and comparison,
  37.     - import of environment variables
  38.     - current time
  39.     - size of files
  40.   - special tags to
  41.     - include files (also verbatim text)
  42.     - execute shell commands (and include output)
  43.     - comment in a reasonable way
  44.   - for local links, checks if file/id exists
  45.   - project relative URIs
  46.   - replaces special characters by entities
  47.   - evaluates attributes for image size (PNG/jfif/gif)
  48.   - strips comments and specified tags
  49.   - strips useless white spaces
  50.   - replaces icon entities by images
  51.   - performs a basic syntax- and structure check
  52.   - easy to extend syntax definition format
  53.   - maintains a project file
  54.   - dependency generator for Makefiles included
  55.   - tool to examine/manipulate project files included
  56.  
  57. NEW FEATURES
  58.  
  59.   - now aborts if a specifiable number of errors occurred
  60.   - as usually, some minor bugfixes and improvements
  61.   - made Postscript version of manual available in a separate archive
  62.  
  63. SPECIAL REQUIREMENTS
  64.  
  65.   AmigaOS 2.04, 2MB of regular memory, 68020, some sort of w3-browser
  66.   and ASCII editor.
  67.  
  68.   For larger projects, 4MB of memory and 68040 are recommended.
  69.  
  70.   Different to many other html-tools, hsc requires an user-IQ > 50. You
  71.   should also know how to work with the CLI and how to write
  72.   Makefiles. You should already have made some experiences with macro
  73.   processors and some programming language (Rexx should suffice).
  74.  
  75. AVAILABILITY
  76.  
  77.   - Every Aminet-mirror, file "text/hyper/hsc.lha", for example:
  78.  
  79.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha
  80.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-source.lha
  81.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-ps.lha
  82.  
  83.   - http://www.giga.or.at/~agi/hsc/
  84.  
  85. PRICE
  86.  
  87.   Freeware.
  88.  
  89. DISTRIBUTABILITY
  90.  
  91.   Distributed under GNU General Public License.
  92.  
  93. SOURCE CODE
  94.  
  95.   ANSI-C source code is available in a separate archive named
  96.   `hsc-source.lha'.
  97.